package com.ruoyi.digest.service;

import java.util.List;
import java.util.Map;

import com.ruoyi.digest.domain.HsGeneratedText;
import com.ruoyi.digest.domain.dto.AnalysisProgressDTO;
import com.ruoyi.digest.domain.vo.AnalysisProgressVO;

/**
 * 热搜主题AI生成文本Service接口
 * 
 * @author lzk
 * @date 2025-06-16
 */
public interface IHsGeneratedTextService 
{
    /**
     * 查询热搜主题AI生成文本
     * 
     * @param id 热搜主题AI生成文本主键
     * @return 热搜主题AI生成文本
     */
    public HsGeneratedText selectHsGeneratedTextById(Long id);

    /**
     * 查询热搜主题AI生成文本列表
     * 
     * @param hsGeneratedText 热搜主题AI生成文本
     * @return 热搜主题AI生成文本集合
     */
    public List<HsGeneratedText> selectHsGeneratedTextList(HsGeneratedText hsGeneratedText);

    /**
     * 新增热搜主题AI生成文本
     * 
     * @param hsGeneratedText 热搜主题AI生成文本
     * @return 结果
     */
    public int insertHsGeneratedText(HsGeneratedText hsGeneratedText);

    /**
     * 修改热搜主题AI生成文本
     * 
     * @param hsGeneratedText 热搜主题AI生成文本
     * @return 结果
     */
    public int updateHsGeneratedText(HsGeneratedText hsGeneratedText);

    /**
     * 批量删除热搜主题AI生成文本
     * 
     * @param ids 需要删除的热搜主题AI生成文本主键集合
     * @return 结果
     */
    public int deleteHsGeneratedTextByIds(Long[] ids);

    /**
     * 删除热搜主题AI生成文本信息
     * 
     * @param id 热搜主题AI生成文本主键
     * @return 结果
     */
    public int deleteHsGeneratedTextById(Long id);

    /**
     * 自动分析所有未处理的主题
     *
     * @return 分析结果统计信息
     */
    Map<String, Object> autoAnalyzeAllTopics();

    /**
     * 查询分析进度
     *
     * @param taskId 任务ID
     * @return 进度信息
     */
    Map<String, Object> getAnalysisProgress(String taskId);

    /**
     * 获取分析进度VO
     * 
     * @param dto 分析进度查询参数
     * @return 分析进度VO
     */
    public AnalysisProgressVO getAnalysisProgressVO(AnalysisProgressDTO dto);

    /**
     * 停止分析任务
     *
     * @param taskId 任务ID
     * @return 停止结果
     */
    Map<String, Object> stopAnalysisTask(String taskId);
}
